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PREFACE 



This document is essentially a collage of DNLS documentation 
culled from various sources, it does not pretend to be 
definitive, but should suffice to equip the new DNLS user with 
a working command vocabulary and an orientation to the display 
mode. 

Related documents: 

For information about TENEX and the Executive command set: 

TNLS User Guide (7^70.) 

This document contains many features common to both 
TNIS and DNLS that are not documented here, e.g., 
EXEC commands, a subset of the Output processor 
Directives, and Error Messages, 

For information about user programs and content analysis: 

L10 Programming Guide (921*6.) 

This document is intended as an introduction to 
writing user programs and content analyzer patterns. 
It assumes a degree of sophistication in DNLS usage. 

For information about the Journal; 

NIC Journal user Guide (7635.) 

This document describes the features of tne current 
journal System. The Journal may be used only through 
TNLS. 

For hardcopy formatting directives: 

Output Processor User Guide (6976.) 

This document contains a summary of all current 
output Processor Directives. Novice users are urged 
to consult the output processor Section of the TNLS 
User Guide (see -- 7U79,) before attempting this 
document. 
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For tne latest dnls information: 

folklore Branch of UNLS Status File (nls.status,!) 

Users are urged to consult the first branch of this 
file for information about new DNLS commands, 
changes, etc. 

For creating NLS files offline: 

DEX user Guide (993k.) 

This document contains a description of the Deferred 
Execution System (HEX) which may ce used to prepare 
DNLS files offline for subsequent online editing. 
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SYNTAX CONVENTIONS 



The following conventions are used in the syntax expressions 
throughout this guide. 

NAMED CHARACTERS 

Special characters such as Command Accept* Command Delete. 
Carriage Return, etc, are referred to by names (CA, CD, CR, 
etc) in uppercase letters. 

Commands are shown in lower case. Most DNLS commands 
require that only the first character of each command word 
be typed, 

COMMANDS 

Commands are shown in lower case. Most DNLS commands 
require that only the first character of each command word 
be typed, 

PARAMETERS 

Values to be supplied &y the user are in shown uppercase. 
The names of these parameters will not cause confusion with 
the uppercase named characters, 

SYSTEM OUTPUT 

Text output by the system as a command is entered is shown 
in lower case letters enclosed in square brackets (/7). 
Brackets are also used to clarify the command, e.g. the 
command insert statement requires only that the user types 
"is". However, this is shown as "if nsert; statement;" in 
the syntax representation for this command, even though 
over the Network, some sites do not receive these 
characters. 

QUANTITY 

In cases where any number of entities might be supplied by 
the user, the entity is preceded by the dollar sign 
character (S) • 
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OPTIONS 



C* 



Many DNLS commands operate on a variety of entities. These 
choices are shown in a vertical column. The general syntax 
of the command applies to all choices except where 
specified elsewise. 



CA means "command accept;" this is done by pressing either 
GA key on the Keyboard, or the right-hand button on the 

w -.ouse. 



"LIT" means any string of characters input from the 
Keyboard or Keyset. 



VIEWPSEC 



The term VIEWSPEC in a syntax equation means that VIEWSPECS 
nay be set, Viewspecs are explained in Section 5 (see — 

10706,) cf this document. 



irUC 



BUG means the selection of an entity (statement, word, 
etc.) on the display. 
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Section 1, DNLS ENVIRONMENT 

1 

THE CONSOLE AND ITS DEVICES la 

The DNLS console is essentially a set of devices mounted in 
or on one or more pieces of furniture. There are several 
styles of consoles involving different types of furniture, 
but the component devices are always the same: the display, 
mouse. Keyboard, and Keyset, lal 

THE DISPLAY lala 

When DNLS is not running, the display simulates a 
Teletype -- whenever a Teletype would issue a 
carriage return and type a new line, the text on the 
display is moved upwards one line and the new line of 
text appears at the bottom. lalal 

When DNLS is running, the screen is specially 

formatted. The elements of the format are described 

here very briefly -- more elaborate descriptions are 

to be found in appropriate sections of this document. Iala2 

FeedbacK Area lala3 

The feedbacK area occupies the top two or three 

inches of the screen. It is divided up into five 

areas, each of which contains a specific type of 

feedbacK information that tells the user what is 

going on and the state of his operations. iala3a 

VIEWSPEC FeedbacK Area lala3b 

In the upper left hand corner are two lines 

that indicate the current status of certain 

parameters called VIEWSPECs, which govern the 

way in which text is displayed in the text area 

of the screen. Most of the time this 

information is displayed in small characters, 

but during certain commands the characters are 

displayed in a larger size, which is a signal 

to the user that VIEWSPEC parameters may now oe 

changed by entering code letters. Iala3bl 
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Command Feedback Line (CFL) lala3c 

At the center of the feedback area is the 
command feedback line or CFL. This displays the 
name of the current command, such as "insert 
Word." If there is no current command, the 
words "Command Reset" are displayed. Whenever 
the name of a command is in the CFL, that 
command is either in progress or "ready to go." 

Iala3cl 
Under the CFL an up-arrow may be displayed at 
certain times and various positions. In 
principle, the meaning of this arrow is as 
follows! Iaia3c2 

when the arrow appears under a word of the 
command name, it means that the word will be 
"set" by any character that the user enters, 

Iala3c2a 
For example, if the CFL reads "Delete 
Word" with the arrow under "word," the 
user may enter a "w" to confirm the 
command "Delete Word," or he may enter 
some other character to get a different 
command, e.g., he may enter a "c" to get 
"Delete Character". Iala3c2al 

on the other hand, if the CFL reads 

"Insert Character" with the arrow under 

"Insert," then any character the user 

enters will change "Insert" to something 

else and advance the arrow to the word 

"Character." If the user now enters an 

"r" the CFL will change to "Replace 

Character" with the arrow under 

"Character." Iala3c2a2 

Additionally, when the arrow is under the 

first word of the command name, it generally 

means that the user may either enter a 

character to change the word, or he may go 

ahead and execute the command. Iala3c2b 

When the arrow is under the second (or 

third) word of the command, the command 

has not been completely specified and the 

user yUST enter a character to either set 

a new word or confirm the one that is 

there. Iala3c2bl 
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As a convenience, when the user wishes 
to confirm a second or third word that 
is already there, he may use the 
special CA (command accept) character, 

Iala3c2bla 
Unfortunately, there are several 
inconsistencies and ambiguities in this scheme, 
which the new user will discover as he goes 
along. Iala3c3 

Address Area iaia3d 

This area, which is usually blank, occupies the 

space just to the right of the CFL. This area 

is used generally to display file or statement 

names or numbers to the user during the 

execution of various comands. Iala3dl 

Date/Time Area lala3e 

This area is at the upper right-hand corner of 

the screen, and displays the current date and 

time. It is updated only when the display is 

recreated by some command (as this happens 

frequently during DNLS use, the time displayed 

is generally quite accurate). Iala3el 

Display Area lalaii 

The remainder of the screen is the Display area, 

used mainly for displaying the user's working text 

-- i.e., part of the contents of some set of 

files, formatted according to viEWSPECs. lalafca 



Literal-input Feedback 



laiaUb 



When the user is typing in new text, the top of 

the text area is cleared as needed and the new 

text appears there as it is being typed in. 

When the string of new text is completed, the 

display is recreated with the new text in place 

in the file as indicated by the user lalaUbl 
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b. The Cursor lala^c 

The cursor is used during the execution of 

commands for selecting operands from the text 

by pointing to them followed by entering the 

special character CA (command accept) from the 

mouse or the keyboard. lalalid 

Whenever such a selection is permitted, the 

cursor appears as an uparrow (this condition 

is referred to as "armed cursor") • lalalicla 

when a cursor selection is not permited, the 

cursor appears as a plus sign (this 

condition is referred to as "disarmed 

cursor"), lalaiiclb 

THE KEYBOARD lalb 

The keyboard closely resembles a conventional 
typewriter keyboard. It has upper- and lowercase 
characters. lalbl 

The keyboard has the usual complement of characters. 

plus the following special characters (none of which 

can be used in text, as they all have special effects 

as soon as they are typed). Ialb2 

CA (Command Accept) lalb3 

This character is used in many places in DNLS 
commands, in general, it causes DNLS to accept 
something specified or to do somethng that has 
been requested. It may be thought of as an 
"affirmative" or a "confirmation." lalb3a 

It is basically used to terminate literal 

typein, select an operand from the screen, or 

give final confirmation for a command. Ialb3al 

CD (Command Delete) lalbii 

This special character is used to abort a command, lalblta 

CENTERDOT lalb* 

This is used to repeat certain commands (such as 
the "Insert Statement" command) without having to 
respecify all of the parameters, lalbSa 
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lalb6 



Each tine this Key or the control A key is pressed 

one character is deleted from current input. ialb6a 



BW (Backspace word) 



lalb7 



Each time this key or the Control A key is pressed 

one word (i.e. one visible) is deleted from 

current input. lalb7a 

THE KEYSET laic 

The keyset has one key for each finger of the left 

hand* The keys are struck in combinations called 

"chords," and each chord corresponds to a character 

or combination of characters from the keyboard. There 

are 31 possible chords; beyond this, two of the 

buttons on the mouse may be used to control the 

"case" of the keyset, giving alternative meanings to 

each chord* There are four cases used, for a total of 

12a possible combinations. laid 

A simple binary code is used, and has proved 
remarkably easy to learn, two or three hours* 
practice are usually sufficient to learn the most 
commonly used chords and develop reasonable speed, lalcla 

The keyset was developed to increase the user's 
speed and smoothness in operating DNLS. It was 
found that users normally keep the right hand on 
the mouse, because the great majority of command 
operations involve a pointing action; efficient 
use of the keyboard, however, requires the use of 
both hands, and shifting the right hand (and the 
user's attention) to the keyboard is distracting 
and annoying if it must De done for each two- or 
three-letter command mnemonic. 



lalclb 



Use of the keyset permits the user to keep his 
right hand on the mouse and his left on the 
keyset, reverting to the keyboard only for 
entry of long strings of text (typically five 
or more characters of text). 



lalclbl 
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originally, the keyset exactly duplicated the 
Keyboard in function; in the development of DNLS. 
however, certain control functions have been made 
two-stroKe operations from the keyset wnere they 
would be three- or four-stroke operations from the 
keyboard. Nevertheless, it is still possible to 
operate all of the features of DNLS without using 
the keyset; thus the beginner may defer learning 
the keyset code until he has gained some degree of 
mastery over the rest of the system. lalclc 

THE MOUSE laid 

The mouse is a rounded box-shaped object, about four 

inches on its longest side, which is moved by the 

right hand. It is mounted on two wheels and a pivot 

point, and rolls on any flat surface. The wheels 

drive potentiometers which are read by an A/D 

converter, and the system causes a tracking spot (or 

cursor) to move on the screen in correspondence to 

the motion of the mouse. laldl 

The user specifies locations in the displayed text 

by pointing with the mouse/cursor combination. 

This eliminates the need for specifying a location 

by entering a code of some kind. Use of the mouse 

is very easily learned and soon becomes 

unconscious. laldla 

on top of the mouse are three special control 

buttons, whose uses are described below. laldlb 

The three buttons on the mouse are used as follows. Iald2 

1. Right-hand Button lald3 

when pushed and released without any intervening 

input, this button gives a CA (command accept). lald3a 

2. Center Button laldli 

When pushed and released without any intervening 

input, this button gives a CD (command delete). ial<Ha 

When it is held down while a string of characters 
is entered from the keyset, this button causes the 
characters to be interpreted uppercase -- see the 
latter part of this section. laldko 



DNLS Preliminary Reference Guide Section l 
/"page 6] 



SRI-ARC 16 JUN 72 1070U 
DNLS ENVIRONMENT 



3. Left-Hand Button laldS 

When pushed and released without any interveneing 
input, this button gives a backspace, causing the 
last input character (in a literal type-in) to be 
thrown away. laldSa 

A backspace made during the process of a cursor 
selection causes the last selection made to be 
cancelled. laldSal 

When it is held down while a string of characters 
is entered from keyset, This button causes the 
characters to be interpreted as case 2 input 
(i.e., letters come out as numbers or punctuation 
marks). laldSb 

lw Left-hand and Center Buttons Together lald6 

When pushed and released without any intervening 
input, this combination gives a backspace-word, 
causing the last input word (in a literal type-in) 
to be thrown away. Iald6a 

When it is held down while a LIT is entered from 
keyset, this combinations causes the LIT to be 
interpreted as CASE 3 input (i.e., letters are 
interpreted as VIEWSPEC control codes. See 
Section 5 -- 10708,). Iald6b 
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MOUSE AND KEYSET, CODES AND CASES lb 

Mouse 

Buttons: ooo oio loo 110 

Case; -0- -1- -2- -3- lbl 

Keyset Code lb2 

X a A I show one level less lb3 

0X0 b B ,f show one level deeper lbli. 

OOOXX c C # show all levels lbS 

00X00 d D S show top level only lb6 

OOXOX e E % current statement level lb7 

00XX0 f F * recreate display lb8 

X X X go • branch show only lb9 

0X000 h H ( g off lbio 

o X X II) show content passed lbll 

0X0X0 j J i or K off lbl2 

OXOXX k K ♦ show content failed lb!3 

0XX00 11 - show plex only lbll* 

OXXOX mM* show statemnt numbers lbl5 

OXXXO n N / hide statemnt numbers lbl6 

OXXXX o o t frozen statement windows lbl7 

X0000 ppO frozen statement off Ibid 

XOOOX qql show one line more lbl9 

XOOXO rR2 show one line less lb20 

XOOXX s S 3 show all lines lb21 

XOXOO t T ij. first lines only lb22 

XOXOX uUS inhibit refresh display Ib23 

XOXXO vV6 normal refresh display lb2U 

XOXXX wW 7 all lines, all levels lb25 

XXOOO xX 8 one line, one level lb26 

XXOOX y ■ Y 9 blank lines on lb27 

XXOXO z Z « blank lines off lb28 

X X X , < i (nothing) lb29 

XXOXO > ; (nothing) lb30 

XXOXO ; : «■ (nothing) lb31 

XXOXO ? \ ALT centerdot lb32 

XXOXO SP TAB CR (nothing) lb33 



DNLS Preliminary Reference Guide Section l 
/"page 6] 



SRIJAHC 16 JUN 72 10705 

FILES 



Section 2. FILES 



FILE STRUCTURE 
INTRODUCTION 



When working in DNLS, one is at all times constructing, 
studying, or modifying a file, DNLS files have a 
hierarchical, tree, or outline structure. 
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FIGURE 1. Hierarchical File structure 



1 

la 

lal 



lala 

lalb 

lalbl 



lalb2 
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It would be difficult to overstate the importance of 
this structure in the design of DNLS; it is 
correspondingly important for the user to understand the 
structure and its terminology. lale 

in the remainder of this discussion of file structure, 
note that every statement is headed by a string of 
digits and letters. These strings are the statement 
numbers associated with the file structure] they have 
been suppressed from the rest of the document, but are 
printed here as an example. Also, the reader is invited 
to observe the way this document is formatted; the 
indentation of statements reflects "level" in the 
structure. lalf 

la2 OVERALL FILE STRUCTURE la2 

ia2a Every DNLS file is made up of STATEMENTS, entities 
which may contain any sort of text (every paragraph and 
heading in this document is a statement) • la2a 

ia2al Every DNLS file has an ORIGIN STATEMENT or 

"zero statement". (The origin statement has been 

omitted from the printout of this document) . The 

origin statement is a "Oth-level" statement (the only 

one in the file). Ia2al 

Ia2a2 The statements immediately below the origin 

statement in the outline are "lst-level" statements 

(all section titles in this document are the 

lst-level statements). Ia2a2 

Ia2a3 The statements immediately below the lst-level 
statements are 2nd-level statements, and so forth to 
arbitrary depth. Ia2a3 

la3 STATEMENT NUMBERS la3 

la3a Every statement has a unique "statement number." 
This is a string of alternating fields of numbers and 
letters. The statement number is a primary means of 
addressing parts of the file in DNLS commands. ia3a 

la3al The first field always contains a number. Ia3al 
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Ia3a2 The number of fields is equal to the level of 

the statement. Properly speaking, the origin 

statement should have no statement number, since its 

level is 0; for convenience, however, the statement 

number "0" is assigned to it. Ia3a2 

Ia3a3 The statement number (and its following space) 

is not Part of the text of the statement; it is 

associated with the position of the statement in the 

file and is subject to change when the file structure 

is modified by adding, deleting, or moving 

statements. Ia3a3 

la3b When necessary, the @ character is used in the 

letter fields of statement numbers as an "alphabetical 

zero." Thus the 26 letters and the @ can be used to 

form a sequence: a, b, c, ... x, y, z, ad, aa, ab, ac, 

... az, b@, ba, bb, ... • la3h 

laa PRIMARY RELATIONSHIPS BETWEEN STATEMENTS lal|. 

lalta The following relationships between statements are 
defined: SUBSTATEMENT, SOURCE, SUCCESSOR, AND 
PREDECESSOR, These are best defined by examples, with 
reference to Figure l on the first page of this section. lalu 

iahal SUBSTATEMENT and SOURCE refer to the 

relationships between statements at different levels, laiial 

lafcala statements i, 2, and 3 are substatements 

of the origin statement, statement la is a 

substatement of statement 1. statements lbl, lb2, 

and lb3 are substatements of statement lb. laliala 

lalialal Any statement may have any number of 
substatements. lal|.alal 

laliala2 All first level statements are 

substatements of the origin statement. Iaiiala2 

laltala3 Given the number of a statement, the 

number of a substatement is obtained by adding 

a field to the end of the last number. laJiala3 

lalialb SOURCE is the inverse of substatement. 

Statement lb is the source of statements lbl, lb2, 

and lb3« Statement 3c is the source of Statement 

3cl. lalialb 
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lalialbl Every statement has .just one source 
(except the origin statement, which has no 
source) • 

lalialb2 Given the number of a statement, the 
number of the source is obtained by removing a 
field from the end of the first number. 

la*a2 SUCCESSOR and PREDECESSOR refer to tne 
relationships between statements of the same level. 

Iai;a2a Statement 2 is the SUCCESSOR of Statement 
1. Statement 3d2 is the successor of Statement 
3dl. 



lakalbl 



laUlb2 



lalu2 



laiia2a 



lal*a2al Not every statement has a successor. 

The origin statement has no successor. No 

statement has more than one successor. A 

statement and its successor always have the 

same level and the same source. A successor 

specification with a statement having no 

succeeding statement of the same level and 

source refers to the statement itself. Iaka2al 

Iaiia2a2 Given the number of a statement, the 

number of the successor is obtained by 

incrementing the last field of the first 

number. Iaiia2a2 

laka2b PREDECESSOR is the inverse of successor. 
Statement la is the predecessor of statement ib. iaaa2b 

lalia2bl Not every statement has a predecessor. 

The origin statement has no predecessor. No 

statement has more tnan one predecessor. A 

statement and its predecessor always have the 

same level and the same source. A predecessor 

specification with a statement having no 

preceding statement of the same level and 

source refers to the statement itself. Ialia2bl 

Iaiia2b2 Given the number of a statement, the 

number of the predecessor is obtained by 

decrementing the last field of the first 

number. Iaiia2b2 
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laS STRUCTURAL ENTITIES MADE UP OF STATEMENTS 

Ia5a Given these primary relationships — • source, 
substatement, predecessor, and successor -- we can 
define the following STRUCTURAL ENTITIES: STATEMENT, 
BRANCH, PLEX, and GROUP, 

laSal STATEMENT has already been explained. 



laS 



la5a 
la5al 



Ia5a2 A BRANCH consists of a specified statement, 
plus all its substatements, all their substatements. 
etc. in the illustration, Branch l consists of 
Statements 1, la, lb, lbl, lb2, and lb3. Branch la 
consists of statement la alone. Branch k consists of 
Statements k$ ka, and lib. laSa2 



laSa2a 
file. 



Branch 0, in any file, contains the entire 



Ia5a2a 



Ia5a3 A PLEX is made up of a specified branch, plus 
all the other branches that have the same source. 
Plex la and Plex lb are the same; each consists of 
Branches la and lb. Plex 3a consists of Branches 
3a, 3b, 3c, and 3d; Plex 3b and 3c, and 3d are the 
same as Plex 3a. 

Ia5a4 A GROUP is a contiguous subset of a plex. it 
is identified by two branches, wnicn must be in the 
same plex, and consists of those two branches plus 
all branches lying "between" them in the same plex. 
Group 3d2c, 3d2c consists of Branches 3d2a, 3d2b, and 
3d2c. 



la6 SECONDARY RELATIONSHIPS BETWEEN STATEMENTS 

la6a we can now define the following relationships; 
HEAD, TAIL, END, UP, DOWN, NEXT, and BACK. 

Ia6al The HEAD of a specified statement is the first 
statement at the same level that has the same source. 
The head of Statement 3d2c is Statement 3d2a. The 
head of Statement 5a2 is Statement 5*1. The head of 
Statement 3a is Statement 3a itself. 

Ia6ala Head pertains only to members of the same 
plex. 



Ia5a3 



laSali 
la6 



la6a 



la6al 



la6ala 
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Ia6a2 The TAIL of a specified statement is the last 
statement at the same level that has the same source. 
The tail of Statement 3d2b is Statement 3d2c. The 
tail of Statement lia is statement lib. The tail of 
Statement 3cl is statement 3d itself. Ia6a2 

Ia6a2a Tail pertains only to members of the same 

plex. Ia6a2a 

la6aj The END of a specified statement is the "last" 
statement in the branch defined by the specified 
statement. The end of Statement 3 is statement 3d2c. 
The end of Statement 3c is Statement 3cl. Ia6a3 

la6aii UP refers to the statement that is one level 
higher than the current statement and precedes the 
current statement. For example, statement 3 is up 
from statement 3c. la6aU 

la6aS DOWN refers to the statement following the 

current statement that is one level lower. For 

example, statement ua is down from statement lu la6aS 

Ia6a5a Any down specification with a statement 
having no following statement at a lower level 
refers to the statement itself. Thus, excess d 
specifications are ignored. la6a£a 

Ia6a6 NEXT refers to the statement immediately 

following the current statment regardless of level or 

of source. For example, statement iib is next to 

statement iia; statement 5 is next to statement lib. Ia6a6 

Ia6a7 BACK refers to the statement immediately 

preceding the current statement regardless of level 

and source. For example, lib is back from statement 

5. Ia6a7 
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FILE CONTENT 



FILE NAMES 



The names of files in TENEX/DNLS are of the following 
form: 

<DIRECTORY>FILENAME, EXTENSION; VERSION # 

where 

DIRECTORY « 1-39 alphanumeric characters, 

excluding control characters, non-printing 
characters, period (.), and semicolon (;)• This 
element is a TENEX user name and is required only 
when a user references a file belonging to a 
directory other than his own (or the one to which 
he is currently connected). 

FILENAME * 1-39 alphanumeric characters, 

excluding control characters, non-printing 
characters, period (•), and semicolon (;) 

EXTENSION * 1-39 alphanumeric characters, 

excluding characters control, non-printing 
characters, period (.), and semicolon (;) 

VERSION # ■ a numeric value (1 to 131071) 

The length of the entire filename (including the 
delimiters . and ;) must not exceed 39 characters. 
Otherwise, there are no restrictions on the length of 
any field within the total filename. . 



lb 
lbl 

lbla 
lblal 

lblb 
lblbl 



lblbla 
lblb2 

lblb2a 
lblb3 

lblb3a 
lblblj. 



lblc 
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TYPES OF FILES lb2 

There is a variety of types of files that are generated 
within DNLS. When a user enters DNLS for the first 
time, he is automatically assigned a file by DNLS. The 
file is empty except for a dummy origin statement which 
contains his identification string as a filename, an 
extension name "DNLS" and version number 1; this file is 
referred to an the user's "initial file". Within DNLS 
itself, files are created by using the Output File and 
output Device commands, see File commands described in 
the latter part of this section. Ib2a 

At this point it is necessary to identify the types of 

files used by the DNLS user. Although the user may use 

any identifier as an extension name, the convention 

generally followed by the DNLS user group is to identify 

the type of the file by the extension name where! Ib2b 

DNLS a an DNLS file lb2bl 

PC = a partial copy file created by DNLS when the 

file is edited in any way Ib2b2 

(NO.) a a sequential file for hardcopy output where 
NO. is the number of copies generated when 
the file is printed Ib2b3 

one of these extension names is automatically supplied 

by the system whenever the user fails to specify 

extension name in a command, depending on the operation 

being performed. Ib2c 

DNLS FILES lb2d 

An DNLS file is a file which may be edited or viewed 

in DNLS. DNLS files are created within DNLS in two 

ways s when the user enters DNLS for the first time. 

a file bearing the users identification string as its 

filename is created by the system; and when the user 

issues the Output File command and specifies a new 

file. Ib2dl 
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PARTIAL COPY FILES lb2e 

Whenever an DNLS file is modified a partial copy file 

is automatically created by the system for that file. 

partial copy files have an extension name "PC" and 

may be used only in conjunction with an DNLS file. 

That is, the user may not load, copy, etc. a partial 

copy file. Ib2el 

when a user attempts to modify an DNLS file, he is 

actually working on the partial copy associated with 

that file. Modifications are actually made to an 

DNLS file only by operations which merge to it the 

contents of its partial copy. Ib2e2 

When a partial copy exists for a particular file, the 

file is considered "locked", i.e. no other partial 

copy may be made for the file. This feature prevents 

other users from modifying the file. A file remains 

locked until the user updates, outputs, or unlocks 

the file via the commands described in the latter 

part of this section. Ib2e3 
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SEQUENTIAL ACCESS FILES lb2£ 

The hardcopy devices used by the system require 

sequential files, i.e., files that are processed as a 

sequence of characters. Any file that is to be 

output at a terminal requires processing by the 

Output Device command which essentially takes a DNLS 

file and copies it into a sequential file for 

processing on a specific device, if the user, when 

issuing the output Device command allows the system 

to 'create* an extension name for the sequential 

file, the extension name will be some number 

depending on the number of copies of the file desired 

by the user. Ib2fl 

SYSTEM CREATION OF FILES lb3 

The TENEX system automatically creates files for the 

user under a variety of circumstances. Ib3a 

NEW FILENAME lb3al 

When the user enters the DNLS system for the first 

time DNLS automatically creates a file for him 

with the name "user's identification 

string. DNLS ;1". Ib3ala 

When the user makes changes to a file in the DNLS 
subsystem, the system automatically creates a 
partial copy file for the opened file. This file 
contains the changes made to the original file. 
With the DNLS command Update File, the user can 
cause the system to add the changes back into the 
original and delete the partial copy. The system 
lists partial copies in the user's file directory 
as separate files with a new file name that it 
creates in the form (USERNAME)FILENAME.PC;#. 



NEW EXTENSION NAMES 



lb3alb 
Ib3a2 



If when the user issues the Output File command in 

DNLS, he enters a unique (to his directory) 

FILENAME followed by a CA. The system will 

automatically assign the file the extension name 

"DNLS". similarly, when the user issues the 

Output Device command, the system automatically 

assigns the file the extension name "TXT". Ib3a2a 
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NSW VERSION NUMBERS lb3*3 

If, when the user outputs a file from DNLS* ne 
enters a FILENAME that exists in his directory, 
the system will automatically assign the file the 
next higher version number, 

Ib3a3a 

USER CREATION OF FILES lbli 

The user may create a new DNLS file by using the Update 

or output command; text files are creted by using the 

output Device command. These commands are described in 

the next part of this section. lolia 

INFORMATION IN THE ORIGIN STATEMENT OF A FILE lbS 

The origin statement of a named file begins with the 

filename, the date and time of the last modification to 

tne file (or date of creation if it is unmodified), and 

the identification string of the user who modified or 

created it (ending with a semicolon), as explained 

below, this information is automatically maintained by 

the system. Ib5a 

Example: 

<SMITH>FILE.DNLS;22, 2ii-MAY-71 11:50 SSS ;7, 19-laU« 

SSS lbSal 
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FILE MANIPULATION AND INPUT/OUTPUT COMMANDS 



1C 



LOAD FILE 1C1 

The load file command causes the file specified to be 
opened and made available to the user for work in the 
DNLS subsystem. lcla 

Uoad; fftlej FILENAME CA lelal 

Where FILENAME « the name of the file to be opened. Icla2 

If the user enters only the name field of 

FILENAME, extension DNLS and the highest version 

number, are the default values for the remaining 

fields, if the file belongs to another user's 

directory, FILENAME must include the directory 

name enclosed in anglebrackets. lcla2a 

When this command is executed, any file and any 
associated partial copy currently open is automatically 
closed before the the file specified in the load file 
command is opened. lclb 

If the file being loaded has an associated partial 

copy, the partial copy is also opened. lclbl 

The user may open a file from another user's 

directory by prefacing FILENAME with <other user's 

name>. However, if the file has an associated 

partial copy created by the other user, the file will 

be "locked" to further changes by anyone but the 

other user (the file may be read only). In this 

case, the user may either request the other user to 

unlock the file, or he may copy the file (in EXEC) so 

that he has a copy in his own directory. However, 

when the file is copied in EXEC, the partial copy 

that causes the file to be locked is not also copied, lclb2 

The file being opened must be an DNLS file. Iclb3 

The user may also access files by using links, lclbk 

Example: lclc 

1 f myfile CA lclcl 
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causes the system to open the most recent version 
of the file myfile.nls in the current user's 
directory, 

1 f <smith>rate.nlsj3 

causes the system to open a file named 
"rate.nls;3" belonging to the directory SMITH, 



lclcla 



1C1C2 



lclc2a 



UPDATE FILE lc2 

The update file command causes the system to merge the 

contents of the current DNLS file with its current 

partial copy. The file created by this merge can either 

be written onto a new version of the same file, or 

written over the old version of the file. Ic2a 

ufpdate file new version FILENAME; CA 

ofld version FILENAME; CA lc2al 

Note: in general, updating to a new version is "safer" 

than updating to an old version. In the event of a 

system crash during an update to an old version, that 

version may be "lost" (along with its partial copy), if 

a crash should occur during an update to a new version. 

the original version and partial copy are not affected 

even though the new version may be lost. Ic2b 

When updating to an old or new version, the current 

partial copy is automatically deleted (but not expunged) 

by the system. Ic2c 

instead of incorporating the partial copy into the 

current file, the user may delete all changes made to 

the file since the last update or output operation by 

using the Execute Unlock command which deletes the 

current partial copy. Ic2d 

Example: If the current file is APPLE;DNLS.i; lc2e 

u o CA lc2el 

causes the current file to remain APPLE. DNLS;ii lc2ela 

u CA Ic2e2 
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causes the current file to be changed to 
APPLE. DNLSJ5 



OUTPUT FILE 

The output File command causes the system to copy the 
content of the currently open file and its associated 
partial copy to the filename specified. 

Ofutput; ffile7 FILENAME CA 

Where FILENAME a the name of the file to be created. 

If only the name field of FILENAME is supplied, the 
system creates a file having the extension name 
"DNLS" and assigns it the next highest version 
number. 

The origin statement of the destination file will 
contain FILENAME, the current date and time, and the 
identification string of the user who is creating the 
file. 

The contents of the currently open file and its partial 
copy are then copied into the named file. Finally, the 
named file is opened and the currently open file is 
closeadand its partial copy is automatically deleted 
(but not expunged) by the system. Thus the Output File 
command always leaves you with the named file open. 

The difference between output File and Update File is 
that the file being created by Output File is ordered 
internally to provide more efficient access and 
storage. 



lc2e2a 
lc3 

lc3a 

lc3al 

lc3b 

lc3bl 

lc3c 



lc3d 



lc3dl 



An attempt to perform an output operation using the 

same filename and version nuaber as the current file 

will cause the system to issue the message: Ic3d2 



FILE BUSY 
and the command will not be executed. 



Ic3d2a 
Ic3d3 



When this command is executed, any partial copy 

associated with the file being output is deleted (but 

not expunged). Ic3dfc 



Example: if there is a file APPLE. DNLSA 



Ic3d5 
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o f apple ca creates a file APPLE. DNLS;5 

lc3<35a 

OUTPUT/UPDATE LOCKED FILE lcli 

When an output or Update File is done on a locked file, 
the user must have write privileges for the directory to 
which the original file belongs (even if the user is 
putting the new file in another directory) • If the user 
doesn't have write privileges, the message "No write 
access to <DIRECT0RY>" is issued. The Output/Update is 
not executed, 

lclia 

EXECUTE UNLOCK lcS 

The Execute unlock command deletes the contents of the 

partial copy associated with the current file. In 

effect the file is restored to its status immediately 

following the last update or output operation on the 

file, lcSa 

execute; u/nlock/ CA /FILENAME really 1} CA lcSal 

Where FILENAME » the name of the current file lc5b 

An extra CA is required to terminate this command to 

decrease the chance of executing this command by 

mistake, lc5c 

If the user attempts an Execute unlock command on a file 

that is not locked, the system will issue the messages 

"This file is not locked". Ic5d 

If the file is locked by someone else, system will issue 
message "You do not have this file locked". Ic5e 

If the user does not have write privileges for the 
directory in which the specified file resides, the 
system will issue the message: "No write access to 
<DIRECTORY>". 

lcSf 

EXECUTE RESET lc6 

The execute reset command creates a partial copy that 

voids the contents of the current file. Ic6a 

e/xecute/ r/eset/ CA /"really ?/ CA lc6al 
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This command is essentially equivalent to deleting plex 

1 of a file. Ic6b 

Like the Execute Unlock Command, this command requires 
an extra terminating CA to decrease the chance of 
executing this command by mistake, (should this command 
be executed by mistake, the Execute unlock command may 
be used to restore the original file, but not the 
partial copy.) 

Ic6c 

EXECUTE FILE VERIFY lc7 

The execute file verify command causes the system to 

check for any problems in the current file that would 

render it unacceptable for processing by DN1S (e.g. 

structural inconsistancy) . Ic7a 

execute; f/ile verify/ CA lc7al 

in response, the system will print; lc7b 

FILE VERIFY IN PROGRESS lc7bl 

If no errors are detected, the above message will go 

away. Otherwise, it issues the message: lc7c 

BAD FILE -- TYPE CA lc7Cl 

This message indicates that the system found an error 
in the file structure. To recover the file use the 
following procedure: lc7d 

1. Issue the Execute Quit command, enter NLS, and 
attempt to load the file. Ic7dl 

2. Execute File verify. If still bad continue to 

next step. Ic7d2 

3. Check partial copy file. Issue the Execute 
Unlock command to delete the current partial copy of 

the file. Ic7d3 

lw Execute File verify. If still bad continue to 

next step. Ic7d^ 
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5. If at this point the error message persists for 
the file, the only recourse is to return to an 
earlier version of the file. Go to EXEC, delete the 
current version, reenter NLS ana load a previous 
version of the file. 



NULL FILE 

A new command, Null File, has been added to TNLS and 
DNLS. It requires a file name, and will create an empty 
file of that name, upon completion of the command the 
user is left with the CM / display start at the origin 
of this new file. 

nfull file; FILENAME CA 

If a file with the specified name already exists, then 
the message "File already exists; CA to proceed" is 
typed, confirmation (a CA) causes DNLS to create a new, 
empty version of the file. Any other character is 
interpreted as a new command. 



EXECUTE OWNERSHIP OF FILE 

The Execute ownership of File command enables the user 
to change the default directory asssociated with all 
link specifications in a file. 

execute; ©Ownership of file; DIRECTORY NAME CA 



EXECUTE FILE STATUS 



Ic7d5 
led 



lc8a 



lc8al 



lc8b 
lc9 

lc9a 

lc9al 
lclO 



The Execute status File command causes the system to 

display status information about the current file, lclOa 

efxecute; stratus; f/*ile/ CA lcioal 

when this command is executed the following information 

is displayed in the upper left portion of the screen: lclOb 

- the filename lclObl 

- whether the file is locKed or not Icl0b2 

- the default directory for links Icl0b3 

- number of statements in the file lclObl* 

- the creation date of the first version of the file lclObS 
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- the creation date of the current version of the 
file 

- number of structure pages 

- number of data pages 

- number of total pages 

- percentage of words used 



EXECUTE LINK STACK STATUS 

This command causes the system to display the current 
link stack in the uDper left portion of the screen. 



efxecute; stratus; l/"ink stack; CA 



OUTPUT DEVICE PRINTER FILE 



lClOb6 
1C10D7 
lClObS 
lClOb? 

lclOblO 

lcll 

lclla 

lcllal 
lcl2 



The Output Device Printer File command causes the system 

to convert the current file from its random file format 

to a sequential format and to process it so that it may 

be listed at the line printer, lcl2a 

The default procedure for the execution of this command 

causes the system to output the current file to a file 

of the same filename in the directory <PRINTER>. The 

system then asks the user how many copies are to be 

generated. This number becomes the extension field of 

the sequential file name. This procedure eliminates the 

need (if appropriate) for the user to copy the file to 

the line printer in the EXEC for each hardcopy required 

of the file. Alternatively, the user may refuse the 

default filename and subsequent automatic listing by 

typing in a filename whose directory is his own, another 

user's, i.e. any directory but <PRINTER>, This causes 

the system to create a sequential file in the specified 

directory which may be subsequently listed by copying it 

to "LPT 5" or some file name in the directory <PRINTER" 

at the EXEC level. This procedure also requires the 

user to specify number of copies of the file. Icl2b 

ofutput; dfevice/ p/rinter file FILENAME; CA... 

FILENAME CA 
.../"copies?; NUMBER CA 
/"output processor in progress; lcl2bl 

when this command is executed, the current DNLS file and 

its partial copy are printed at the terminal. Icl2c 
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This processor may be interrupted at any time by issuing 

the interrupt Control o. Icl2d 

The file is printed beginning with the statement 
currently at the top of the display area. To print an 
entire file, the file must be displayed starting at 
statement 0. Icl2e 

The user may control the format of the output from 

within the file by using the directives described in the 

output Processor Guide (7ii77*). output format may also 

be controlled by setting the viewspecs discussed in 

Section 5 (see -- 10706,) of this document prior to 

issuing the output Device command. Icl2f 
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Section 3. ADDRESSING IN DNLS - JUMPING AND LINKS 



JUMPING 



la 



DNLS files may, of course, contain a great deal more text 
than can be displayed on the screen, just as a document may 
contain more than one page of text. An DNLS file is thought 
of as a long "scroll." The process of moving from one point 
in the scroll to another, which corresponds to turning 
pages in hard copy, is called "dumping." There is a very 
large family of Jump commnds. 

The basic Jump command is Jump to Item. The user 
specifies it by entering 'j or M ji", and then either 
selects some statement with the cursor (using the mouse) 
or types in SPACE followed by the name or number of a 
statement. The selected statement is moved to the top of 
the screen. 

Most of the jump commands reference the hierarchical 
structure of the text. Thus jump to successor brings to 
the top of the display the next statement at the same 
level as the selected statement; jump to Predecessor 
does the reverse; jump to Up starts the display with the 
statement of which the selected statement is a 
substatement, and so forth. 

The jump to Name command uses a different way of 
addressing statements. If the first word of any 
statement is enclosed in parentheses (this is the system 
default -- the user can change the delimiter 
characters), the system will recognize it as the "name" 
of the statement. Then, if this word appears somewhere 
else in the text, the user may jump to the named 
statement by pointing to the occurrence of the name, or 
by typing the name. 

This provides a cross-referencing capability which is 
very smooth and flexible; the command Jump to Return 
will always restore the previous display, so that the 
user may follow name references without losing his 
place. 

It is also possible to jump to a statement by typing its 
statement number. 



lal 



lala 



lalb 



laic 



lalcl 



laid 



DNLS Preliminary Reference Guide 



Section 3 
fpage 1/ 



10705 16 JUN 72 SRI-ARC 

ADDRESSING IN DNLS - JUMPING AND LINKS 



JUMP COMMANDS lb 

jump to Origin Ibl 

The display start is positioned to the origin statement. lbla 

jfump to/ ofrigin; VIEWSPEC CA lblal 

jump to Item lb2 

The display start is positioned to the selected 

statement. Note that the i in the command specification 

may be omitted. Ib2a 

jfump to item; iftem; BUG VIEWSPEC CA 

NULL lb2al 

jump to Up lb3 

The display start is positioned to the source statement 

of the selected statement lb3a 

jfump to/ u/"p; BUG VIEWSPEC CA lb3al 

Jump to Down lbl* 

The display start is positioned to the first 

substatement of the selected statement lbiia 

jrump to; d/own; BUG VIEWSPEC CA lbkal 

jump to Successor lb5 

The display start is positioned to the successor of the 

selected statement lb5a 

jfump to; successor; BUG VIEWSPEC CA lbSal 

jump to Predecessor lb6 

The display start is positioned to the predecessor of 

the selected statement. Ib6a 

jfump to; predecessor; BUG VIEWSPEC CA lb6al 
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jump to Head lb7 

The display start is positioned to the first statement 

in the plex where the selected statement is found. Ib7a 

jfump to; hfead; BUG VIEWSPEC CA lb7al 

jump to Tail lbft 

The display start is positioned to the last statement in 

the plex where the selected statement is found. lbda 

j/"ump to; tfaii; BUG VIEWSPEC CA lb8al 

jump to End of item lb9 

The selected statement determines a branch, and the last 

statement in that branch is placed at the top of the 

display. Ib9a 

j/ump efnd of; iftem; BUG VIEWSPEC CA 

NULL lb9al 
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LINKS 



1C 



A "link" is a string of text, occurring in an ordinary file 
statement, which indicates a cross-reference of some kind. 
It may refer to another statement in the file, or to a 
statement in some other file, possibly belonging to another 
DNLS user. Using links is similar to the Load File command 
except that it is quicker and allows the user to reference 
any location in the file. Using links also enables the 
user to embed precise cross-references in a file for 
subsequent on-line reading. 

The text of the link is both human»readable and 
machine-readable, and the command Jump to Link permits the 
user to point to the link with the mouse and immediatly see 
the material referenced. 

in general, the syntax of the link is: 

(directory, filename, address :viewspec) 

directory * 

the directory associated with the filename. If not 
specified, the current user's directory is assumed 
unless the Declare Default Directory command (see 
Section 2. -- 10705,) was used to specify another 
directory. 

filename » 

the name of the file to be accessed (i.e., the name 
field only), if filename is omitted, the system 
assumes that the link refers to a location in the 
current file. 

address a 

a statement number or name indicating the exact 
location in the file which appear as the first 
statement on the display. If address is not 
specified, the system assumes the origin statement of 
the file. 



lcl 



lc2 

lc3 

lc3a 

lc3o 



lc3bl 
lc3c 



lc3cl 
lc3d 



lc3dl 
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viewspecs ■ lc3e 

a series of view specifications, or format codes 

which control the way the file will appear when 

accessed through the link. If not specified, the 

system uses the viewspecs i effec when the link is 

executed. Viewspecs are discussed later in this 

document (see Section 5 -- 10706,), lc3el 

Links are usually delimited by right parentheses. However, 

they may also be delimited by angle brackets ("< M and ">") 

or preceded by two dashes ( M -- M ). Also, right and left 

delimiters may be used in any combination, e.g. a link may 

begin with the chracters "--" and end with a left 

parethesis. lcli 

An example of a link is (Smith, Plans, Longrange:ebtng) . Ic5 

The first item in the link indicates that the refernced 

file belongs to a user named Smith; the second is the 

name of the file; the third is the name of a statement 

in the file (a statement number may also be used); and 

the string of characters following the colon controls 

the VIEWSPECS to set up a particular view of the 

material. lcSa 

The use of interfile links permits the construction of 
large linked structures made up of many files, and study 
of these files as if they were all sections of a single 
document. Ic5b 

other examples include* lc6 

(see — 7000,) lc6a 

<3> lc6b 

(myfile,:x) lc6c 
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RETURN JUMPS Id 

General 161 

The commands "Jump to Return" and "Jump to File Return" 

permit the user to return automatically from any jump to 

a previous view. Thus links may be freely used without 

the danger of losing one's place. ldla 

The Intrafile Return Ring ld2 

All dumps made within a file (except jumps made with 
"Jump to Return" and "Jump to Ahead") are recorded in an 
ordered list called the Intrafile Return Ring, The ring 
may have up to five entries, each of which records a 
display start position and a set of display parameters 
-- i.e. the information needed for complete 
reconstruction of a view, assuming that no editing takes 
Place. Id2a 

The list is a ring in the sense that its ends are 

joined; i.e. the first entry is also the list successor 

of the last entry. A pointer indicates the "current" 

entry, i.e., the entry containing information for the 

current view. Each new jump (except "Return" and 

"Ahead") causes a new entry to be made ahead of the 

current entry, and the pointer is moved to the new 

entry. Id2b 

The command "Jump to Return" causes the pointer to be 

moved back one entry and the display is recreated from 

the new "current" entry, no changes are made in the 

entries themselves. Id2c 

The command "Jump to Ahead" causes the pointer to be 
moved forward one entry, and the display is recreated 
from the new "current" entry. No changes are made in the 
entries themselves. Id2d 

It will be seen that because of the ring structure of 

the list, repeated use of "Jump to Return" or "Jump to 

Ahead" will eventually bring the user back to the 

starting point. Id2e 
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The user may "step" through the ring by issuing either 

the Jump to File Return or the Jump to File Ahead 

command and entering a Space character instead of the 

confirming CA when the name of the next file in the ring 

is displayed on the screen. The user may continue 

hitting the space character in response to each filename 

displayed on the screen until any particular file is 

found whereupon entering a CA in response to the desired 

filename will cause the system to execute the return or 

ahead. ld2f 

It should also be remembered that each new entry in the 
ring always goes just ahead of the "current" entry, and 
that an old entry may be overwritten in the process, ld2g 

The "Jump to File Return" and "Jump to File Ahead" 
Commands ld2h 

These commands are exactly analogous to the 

corresponding intrafile jump commands. "Jump to File 

Return" moves the pointer back one entry and creates 

a new display from the information in the new 

"current" entry, and "jump to File Ahead" does the 

reverse. Id2hl 
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Section lw EDITING AND COMPOSITION 



COMPOSITION la 

Composition is simply the creation of new text material as 
content for a file. lal 

In the simplest case, the user gives the command "Insert 

Statement" by typing "is". He then points (using the 

mouse) to an existing statement; the system displays a new 

statement number which is the logical successor, at the 

same level, as the statement pointed to. The user may 

change the level of this number upward by typing a "u" or 

downward by typing a "d". The new statement number is 

changed accordingly by the system. Ia2 

The user then types the text of the new statement from the 

keyboard, on the screen, the top part of the text-display 

area is cleared and characters are displayed here as they 

are typed, when the statement is finished, the user hits a 

CA (command accept) button on the keyboard or mouse, and 

the system recreates the display with the new statement 

following the one that was pointed to. la3 

New material may also be added to existing statements by 

means of commands such as insert word, insert Text, and 

others. Properly speaking, these operations are for 

modification rather than composition, and are discussed 

below. lal* 

EDITING lb 

A large repertoire of editing commands is provided for file 

modification. These commands operate upon various kinds of 

text entities, within statements, they may operate upon 

single characters, words, and arbitrary strings of text 

defined by pointing to the first and last characters. lbl 

This set of commands is not restricted to operation 

within one statement at a time; for example, a word may 

be moved or copied from one statement to another. lbla 
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The editing functions also operate at the structural level, 
taking statements or sets of statements as operands. A 
number of special entities have been defined for this 
purpose: for example, a "branch" consists of some specified 
statement, plus all of its substatements, plus all of their 
substatements, etc, A branch can be deleted, moved to a new 
position in the structure, etc. 102 
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COMMANDS 1C 

INSERT 1C1 

insert Character lcla 

LIT is inserted immediately after the selected 

character lclal 

Unsert; character/ BUG LIT CA lclala 

insert Word lclb 

LIT is inserted after the selected word* with an 

intervening SPACE. lclbl 

i/nsert; wford/ BUG LIT CA lclbla 

insert Visible lclc 

LIT is inserted after the selected visible, with a 

SPACE between, lclcl 

i/nsert; visible; BUG LIT CA lclcla 

insert Link lcld 

The link is inserted after the selected visible, with 

a SPACE between. lcldl 

i/*nsert; Uink; BUG LIT CA lcldla 

LIT and the visible selected by BUG are both required 

to have the syntax of a valid link (see Section 3 of 

this document — 10706). Icld2 

Insert Number lcle 

LIT is inserted after the selected visible, with a 

SPACE between. lclei 

i/nsert/ number; BUG LIT CA lclela 

insert Text lclf 

LIT is inserted after the selected character. This 

command is identical to the insert character command, lclfl 

i/nsert; t/exW BUG LIT CA lclfla 
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insert Invisible lclg 

LIT is inserted immediately after the selected 

invisible. lclgl 

ifnsert/ invisible/ BUQ LIT CA lclgla 

insert Statement lclh 

LIT becomes the text of a new statement or set of 
statements, following the selected statement at a 
level determined by the LEVADJ. lclhl 

ifnsert; statement; BUG SLEVADJ SPACE LIT CA 

NULL CA CDOT lclhla 

LEVADJ = lclh2 

any number of up or down level specifications (u 

or d respectively) which indicates that the 

statement to is be inserted x levels higher or 

lower than the statement specified by BUG, u and d 

may also be preceded by an integer value 

indicating the number of levels up or down. This 

specification may include both u's d's • which 

cancel out each other on a one-to- one basis. lcih2a 

CDOT * lclh3 

"center dot" character means continue insert 

command. This option allows the user to continue 

inserting statements at the same and/or other 

levels. When this delimiter is used, the syntax 

for inserting subsequent statements is the same as 

though the user had entered the insert command uo 

to and including the first CA; the system expects 

the user to enter a level specification and/or 

LIT. lclh3a 

When a new statement is inserted into a file, all 
statements following the place of insertion are 
automatically renumbered by the system as necessary. lclhfc 

The maximum number of characters allowed per 

statement is approximately 2000. Every statement 

consists of at least one character. IclhS 
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After this command is executed the CM is positioned 
to the first character of the most recently inserted 
statement, lclh6 
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Section 5. VIEW CONTROL OPERATIONS 



VIEWSPECS 

INTRODUCTION 

in DNLS the user is at all times "viewing" a file. 
Certain parameters are in effect at all times which 
control the precise nature of the view a user has of a 
file. These parameters are called viewspecs and several 
of the DNLS commands documented in this Reference Guide 
allow their specification as part of the execution of 
the command, 

Generally speaking, the most common and important use of 
viewspecs is to cause some of the statements in the file 
(or part of the file) to pe ignored (not displayed) for 
various reasons. Thus, for example, certain important 
viewspecs have the effect of ignoring all statements 
that are below a specified level in the hierarchical 
file structure. 

When the user first enters DNLS* all of the viewspecs 
are automatically preset to standard values. 
Whenever the user issues a viewspecs command or 
certain others as noted in this document, he has the 
option of changing any of the viewspecs by typing 
special one-letter codes. 

VIEWSPEC CONTROL 

viewspecs may be controlled in four ways; during certain 
commands such as jump or Load, with the View set 
command, in a link or from the keyset in Case 3. (The 
viewspecs may also be set from the keyboard with the 
right-hand and center buttons on the mouse down, i.e. in 
Case 3 position.) 

During the Jump and Load commands (and a few others), 
there is a point where the VIEWSPECS in the upper 
left-hand corner of the display become large, 
indicating that all VIEWSPECS are accessible to 
change. They may then be changed by typing the codes 
in from the keyboard or keyset as upper- or 
lower-case letters. 



1 

la 

lal 



lala 



lalb 



lalbi 
la2 



la2a 



la2al 
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The View set command may be used to achieve exactly 

the same effect without doing anything else, Ia2a2 

A link may contain a string of VIEWSPEC codes, 
preceded by a colon, as the last element in the 
parentheses. Ia2a3 

Case 3 may be used to set all of the VIEWSPECs that 

are not capital letters, as shown in the table of 

keyset codes. This may be done at any time. Ia2ali 

Note that the chord for each VIEWSPEC corresponds 

to the appropriate lower-case letter in Case o. Ia2alia 

After VIEWSPECs have been given in this fashion, 
it is necessary to hit Chord 00110, Case 3 for 
"new view," (or otherwise cause the display to be 
recreated), before the new VIEWSPECs will become 
effective. Ia2aiib 

VIEWSPEC DEFINITIONS la3 

INTRODUCTION la3a 

There are two types of viewspecs. The first type 

includes the Level and Line specifications whose 

value may range from 1 to ALL. Ia3al 

The remaining viewspecs are ON/OFF switches for 

various DNLS features. Each is controlled by a pair 

of one-letter codes, one of which turns the feature 

ON and the other of which turns it OFF. Note that 

some of these codes are capital letters; it is 

important to distinguish between capital and 

lower-case viewspec codes, because they have 

different effects. Ia3a2 

LEVELS VIEWSPEC la3b 

The Levels viewspec specifies how many levels of the 

file structure are to be displayed. Initially, level 

is set to its standard value of ALL. Ia3bl 

DNLS displays only statements whose level is equal to 

or higher than the current level specification. 

This viewspec also affects the output in the Output 

Device command and restricts the effect of the 

Substitute and Assimilate commands. Ia3b2 
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d 


sets 


L 


to 1 


c 


sets 


L 


to ALL 


a 


sets 


L 


to L-l 


b 


sets 


L 


to L+l 


e 


sets 


L 


relative 



Ia3b2a 



(i.e. L is set to the level of the first 
statement to be displayed by the command, i.e. 
the statement specified in the command.) For 
example, if a "jump to item" specified a 
statement whose statement number was "5a2", 
only first, second, and third level statements 
would be displayed. 



Ia3b2al 

Ia3b3 



where L * current level specification 

Note: it is possible to set the Levels viewspec to 

by use of the a viewspec. However, this setting is 

meaningful only if the origin statement is displayed. 

When the Levels viewspec in is effect, only the 

origin statement is displayed, la3bli 

LINES VIEWSPEC la3c 

The lines viewspec is a value from 1 to ALL which 

allows the user to specify how many lines of each 

statement are to be displayed. The lines viewspec is 

preset to ALL; if the user changes it to, for 

example, 3, only the first three lines of any 

statement will be displayed. Ia3cl 

The codes for setting the lines viewspec are as 

follows: Ia3c2 

t sets T to l 

s sets T to ALL 

q sets T to T-l 

r sets T to T*l la3c2a 

LINES AND LEVELS VIEWSPECS la3d 

In addition, to the viewspecs for lines and levels 
there are two extremely useful codes that affect both 
levels and lines: la3dl 

x sets levels and lines to 1 

w sets levels and lines to ALL la3dla 
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STATEMENT NUMBERS ON/OFF (Codes m/n) la3e 

Normally, when a statement is displayed, its 

statement number is not printed at the beginning of 

the firat line, statement numbers may be seen by 

using the viewspec "m". Ia3el 

m turns statement numbers ON 

n turns them OFF, la3ela 

The standard setting for this viewspec is OFF (n). Ia3e2 

STATEMENT NAMES ON/OFF (Codes C/D) la3* 

Normally, when a statement is displayed, its 

statement name (if any) is visible, la3fl 

C turns statement names ON 

D turns them OFF la3fla 

The standard setting for this viewspec is ON (C). la3£2 

BLANK LINES BETWEEN STATEMENTS ON/OFF (Codes y/Z) la3g 

The viewspec code "y" causes DNLS to put blank lines 

between statements. This makes the display more 

readable, la3gl 

y turns blank lines ON 

z turns them OFF, Ia3gla 

The standard setting for this viewspec is OFF (z). Ia3g2 

INDENTATION OF STATEMENTS ACCORDING TO LEVEL ON/OFF 

(Codes A/B) la3h 

DNLS normally indents according to level when it 
displays statements. This can be suppressed by the 
viewspec "B", causing all statements to be displayed 
flush at the left margin. Ia3hl 

A turns indenting ON 

B turns indenting OFF Ia3hla 

The standard setting for this device is ON (A), Ia3h2 
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CREATE NEW VIEW (Code F) la3i 

The VIEWSPEC code f has a special effect; instead of 

setting a parameter* it acts as a "command," causing 

the display to be recreated and putting into effect 

any parameter changes that have been made since the 

last time the display was recreated. Ia3il 

AUTOMATIC DISPLAY RECREATION (Codes u/v) la3J 

Certain commands cause the display to recreated when 

executed. The user may defer display recreation 

(i.e., until the user issues a command which 

specifically recreates the display, such as jump to 

item, or issuing the M f H viewspec) by using the 

Viewspec "v" • This feature is useful when the user 

is performing a repetitious series of insert 

statements, xset commands, etc. However, caution 

should be exercised when using this viewspec as the 

user may unintentionally affect statements previously 

moved, inserted, etc. while this viewspec is in 

effect. Ia3jl 

u causes the display to be automatically recreated la3jla 

v inhibits automatic display recreation la3jlb 

The normal setting is u (recreate display) la3Jlc 

DISPLAY MODE BRANCH-ONLY/NORMAL/PLEX-ONLY (Codes g/h/i) la3k 

When the display mode is BRANCH-ONLY, DNLS looks for 

the end of the branch defined by the display-start 

statement. If it comes to the end of the branch, it 

ends the display there. Thus, in effect, it displays 

only one branch (of course, the branch may not fit on 

the display, in which case the BRANCH-ONLY mode makes 

no difference for that view) . Ia3kl 

Similarly, when the display view is PLEX-ONLY the 
display is restricted to the plex defined by the 
display-start statement. la3K2 

Normally, DNLS keeps putting more statements on the 

display until the screen is full or the end of the 

file is reached. Ia3*3 

g sets view to BRANCH-ONLY Ia3k3a 
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h sets it to NORMAL Ia3k3b 

1 sets it to PLEX-ONLY la3K3c 

The default setting is normal (h). Ia3k3d 

This viewspec affects output Device, Output 
Quickprint, output Sequential File, and Substitute 
commands. la3Kii 

FROZEN STATEMENT DISPLAY ON/OFF (Codes 0/P) la31 

If this feature is ON, any statements that have been 

frozen with previous "Freeze" commands (see section U 

— 10707,) are displayed at the top of the screen. 

Below the last frozen statement is a dotted line, 

followed by as much of the normal display as will 

fit. la3U 

o turns frozen statements ON Ia31ia 

p turns frozen statements OFF. la311b 

The standard setting is OFF (p). Ia311c 

VIEW SET COMMAND la3m 

The View set command enables the user to use the 
viewspec features of DNLS at any time (i.e. besides 
during link, output device, jump to, substitute, etc. 
operations). Ia3ml 

Wiew set; VIEWSPECS CA la3mla 

where VIEWSPECS = any series of valid viewspec 

codes Ia3m2 

Viewspecs activated by the View, Jump to, etc. 
commands remain in effect until deactivated by their 
opposites in subsequent commands, or until the user 
leaves DNLS. Ia3m3 
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VIEWSPEC DISPLAY AREA AND DEFAULTS VIEWPSECS la ft. 

The current settings of six viEWSPECs are displayed on 

two lines in the upper left-hand corner of the screen. lalia 

The top lines shows "L" and "T" , which appear either 

as numbers or as the word "ALL. M lalial 

The second line shows four ViEWSPECs: laiia2 

g, 1, or h for branch-only, plex only, or normal 

mode ialu2a 

i# J* or k for content-analyzer on, off, or 

reversed Ialta2b 

The use of content analyzer patterns and the 
viewspecs which effect them are described in 
the L10 Programming Guide (see -- 921*6,), lalia2bl 

m or n for statement numbers on or off iaiia2c 

u or v for recreate or defer recreate ialia2d 
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MULTIPLE DISPLAY AREAS 

ordinarily, in DNLS, the user has one "view" of a file. 
There are a set of commands which, however, enable the user 
to expand the number of views he may have of the same 
and/or other files. This feature is governed by the Goto 
Display area subsystem which consists of the following 
command set. 

GOTO DISPLAY AREA CONTROL 

This command allows the user to execute commands 
which control the number of views the user may have 
of files. 



lb 



gfoto/ display area control/ 

Once the user enters the sequence of characters "g 
d", DNLS expects any of the following subcommands. 

HORIZONTAL SPLIT 

This command splits the display horizontally. 

horizontal split; BUG CA 



lbl 
lbla 

lblal 
lblaia 

lbla2 

lbla3 

lbla3a 

lbla3al 



The display is split where the BUG occured 

horizontally (into an upper and lower segment) at 

the bugged location moving the image of the 

original display area to the upper or lower 

segment depending on whether the cusor is above or 

below the bugged position when the final CA is 

input. lblajb 

No display area will be created which is 
smaller then two lines by 20 columns (using the 
character size of the original display area) . Ibla3bl 



VERTICAL SPLIT 

This command splits the screen vertically, 
v/ertical split; BUG CA 



lblaii 

lblafca 

lblalul 
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The display area is split where the BUG occured 
vertically (into a left and right segment) at the 
bugged location moving the image of the original 
display area to the left or right segment 
defending on whether the cursor is to the left or 
right of the bugged position when the final CA is 
input. lblaltb 

No display area will be created which is 
smaller then two lines by 20 columns (using the 
character size of the original display area), lblalibl 

MOVE BOUNDARY lblaS 

This command enables the user to move view area 
boundaries. lblaSa 

m/"ove boundary; BUGl BUG2 CA lblaSal 

The selected boundary (BUGl) is moved to the new 

position (BUG2). A boundary will not be moved 

passed a boundary of a neighbor* A boundary is 

moved for all display areas for which it is a 

boundary. Any resulting display area which is 

smaller than two lines by 20 columns will be 

deleted. Ibia5b 

FORMAT DISPLAY AREA/CHARACTER SIZE lbia6 

This command allows the user to change the image 

size of the character on the display. lbla6a 

f/"ormat display area; character size; NUMBER CA lbla6b 

The current character size of the display area 
which currently contains the cursor is displayed, 
and the user may type a number (0, 1, 2, 3) for a 
new character size. The final CA causes the 
character size to be changed. The horizontal and 
vertical increments are automatically adjusted. 
Different display areas may simultaneously have 
different character sizes. Ibla6c 
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CLEAR DISPLAY AREA lbla7 

The bugged display area is cleared, i.e. the image 

is erased, the return and file return rings are 

released, and the association of a file with that 

display area is removed. The display area itself 

is not deleted. Ibla7a 

cflear display area/ BUG CA lbla7al 

One may freely edit and jump using several display areas. 

The position of the cursor is used to resolve ambiguities. Ib2 

For example, If one executes a Jump command, the 

position of the cursor when the final command accept is 

entered determines in which display area the new image 

is to appear. Ib2a 

Also, if one changes viewspecs using the leftmost two 
buttons of the mouse, the viewspecs of the display area 
containing the cursor when the buttons go down are used 
as the initial values and are displayed in the viewspec 
area. When the buttons are released, the display area 
containing the cursor receives the new viewspecs. Ib2b 
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Section 6. DNLS/EXEC 

1 

INTRODUCTION la 

The only EXECUTIVE command documented here is the DNLS 

access command. All other commands of interest to the DNLS 

user are documented in the TNLS User Guide (see — 7U70,). lal 

ACCESSING DNLS lb 

In order for the user to enter DNLS, he must use the 

EXECUTIVE command DNLS. lbl 

dnls CR 

tiaij IDENT CR 

/"device:/ d/'isplay./ lbla 
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